src: add setTitle() as alternative to direct assignment by JonathanLopes404 · Pull Request #62804 · nodejs/node

JonathanLopes404 · 2026-04-18T13:44:29Z

Implement process.setTitle(title) as a new function-based API for setting the process title, complementing the existing process.title property assignment pattern

Fixes: #62797

nodejs-github-bot · 2026-04-18T13:44:36Z

Review requested:

@nodejs/startup

addaleax

Why does this introduce a new native method? Adding the new API is fine, but it should just trigger the same code paths.

JonathanLopes404 · 2026-04-18T23:35:25Z

@addaleax Updated in latest commit: setTitle now reuses the existing process.title path (removed native method). Could you please take another look?

nodejs-github-bot · 2026-04-19T14:26:33Z

CI: https://ci.nodejs.org/job/node-test-pull-request/72786/

codecov · 2026-04-19T15:30:09Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.65%. Comparing base (42a154b) to head (121f4fa).
⚠️ Report is 4 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #62804      +/-   ##
==========================================
+ Coverage   89.64%   89.65%   +0.01%     
==========================================
  Files         706      706              
  Lines      219394   219409      +15     
  Branches    42066    42067       +1     
==========================================
+ Hits       196674   196719      +45     
+ Misses      14629    14585      -44     
- Partials     8091     8105      +14

Files with missing lines	Coverage Δ
...l/bootstrap/switches/does_not_own_process_state.js	`100.00% <100.00%> (ø)`
...ernal/bootstrap/switches/does_own_process_state.js	`95.33% <100.00%> (+0.19%)`	⬆️

... and 27 files with indirect coverage changes

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

silverwind · 2026-04-19T15:38:12Z

Would add a reference on bottom of the process.title docs to point to the new alternative.

ljharb · 2026-04-20T23:54:20Z

I'm confused why an alias for x => { process.title = x } is helpful - if it were an entirely new method, such that one could eventually deprecate the assignment form, that'd be one thing.

Separately, is it expected that if i Object.defineProperty(process, 'title', { writable: false, configurable: false }), setTitle will throw?

JonathanLopes404 · 2026-04-21T12:27:46Z

Hello @ljharb,

Regarding the usefulness: the primary motivation is to support modern ESM usage. Since ESM bindings are read-only, users cannot do import { title } from 'node:process'; title = 'new'. By providing setTitle, we allow developers to use named exports effectively without needing to import the entire process object, which aligns with how other modern APIs are being shaped.

About Object.defineProperty:
Yes, it is expected to throw. Since wrappedSetTitle internally performs process.title = title, it will respect the property descriptors of process.title. If the property is made non-writable or non-configurable, the setter will throw a TypeError, maintaining consistency with the current behavior of the process object.

silverwind · 2026-04-21T12:34:40Z

I checked if there are more similar APIs that would need similar treatment and process.title appears to be the only setter API in the whole Node API, so it's complete treatment for the topic.

A deprecation of process.title could also be considered, maybe not now, but for the future.

ljharb · 2026-04-21T18:03:49Z

Fair point on the ESM usage.

Implement process.setTitle(title) as a new function-based API for setting the process title, complementing the existing process.title property assignment pattern Fixes: nodejs#62797 Signed-off-by: Jonathan Lopes <[email protected]>

Add process.setTitle(title) as a new API while reusing the existing process.title assignment behavior instead of introducing a separate native code path. Signed-off-by: Jonathan Lopes <[email protected]>

Add a cross-reference at the end of the process.title section to point to process.setTitle() as the new alternative API. Signed-off-by: Jonathan Lopes <[email protected]>

nodejs-github-bot · 2026-04-26T08:42:43Z

CI: https://ci.nodejs.org/job/node-test-pull-request/72928/

nodejs-github-bot added c++ Issues and PRs that require attention from people who are familiar with C++. lib / src Issues and PRs related to general changes in the lib or src directory. needs-ci PRs that need a full CI run. labels Apr 18, 2026

addaleax requested changes Apr 18, 2026

View reviewed changes

JonathanLopes404 requested a review from addaleax April 18, 2026 23:35

addaleax approved these changes Apr 19, 2026

View reviewed changes

addaleax added semver-minor PRs that contain new features and should be released in the next minor version. author ready PRs that have at least one approval, no pending requests for changes, and a CI started. request-ci Add this label to start a Jenkins CI on a PR. labels Apr 19, 2026

github-actions Bot removed the request-ci Add this label to start a Jenkins CI on a PR. label Apr 19, 2026

JonathanLopes404 requested a review from addaleax April 19, 2026 20:18

JonathanLopes404 force-pushed the fix/issue-62797 branch from f0e771a to 685682f Compare April 20, 2026 23:32

ljharb reviewed Apr 21, 2026

View reviewed changes

Comment thread lib/internal/bootstrap/switches/does_not_own_process_state.js

Comment thread lib/internal/bootstrap/switches/does_own_process_state.js

ljharb approved these changes Apr 21, 2026

View reviewed changes

silverwind reviewed Apr 23, 2026

View reviewed changes

Comment thread doc/api/process.md

addaleax added the request-ci Add this label to start a Jenkins CI on a PR. label Apr 25, 2026

JonathanLopes404 added 4 commits April 25, 2026 19:44

src: add setTitle() api reusing process.title path

bfa61b0

Add process.setTitle(title) as a new API while reusing the existing process.title assignment behavior instead of introducing a separate native code path. Signed-off-by: Jonathan Lopes <[email protected]>

doc: add process.setTitle() reference in process.title docs

3ac6c46

Add a cross-reference at the end of the process.title section to point to process.setTitle() as the new alternative API. Signed-off-by: Jonathan Lopes <[email protected]>

doc: format markdown

121f4fa

JonathanLopes404 force-pushed the fix/issue-62797 branch from c317652 to 121f4fa Compare April 25, 2026 22:57

theanarkh approved these changes Apr 26, 2026

View reviewed changes

theanarkh added request-ci Add this label to start a Jenkins CI on a PR. and removed request-ci Add this label to start a Jenkins CI on a PR. labels Apr 26, 2026

github-actions Bot removed the request-ci Add this label to start a Jenkins CI on a PR. label Apr 26, 2026

Uh oh!

Conversation

JonathanLopes404 commented Apr 18, 2026

Uh oh!

nodejs-github-bot commented Apr 18, 2026

Uh oh!

addaleax left a comment

Choose a reason for hiding this comment

Uh oh!

JonathanLopes404 commented Apr 18, 2026

Uh oh!

nodejs-github-bot commented Apr 19, 2026

Uh oh!

codecov Bot commented Apr 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

silverwind commented Apr 19, 2026

Uh oh!

ljharb commented Apr 20, 2026

Uh oh!

JonathanLopes404 commented Apr 21, 2026

Uh oh!

silverwind commented Apr 21, 2026

Uh oh!

ljharb commented Apr 21, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

nodejs-github-bot commented Apr 26, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

codecov Bot commented Apr 19, 2026 •

edited

Loading